home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / PROGTOOL / MDF120.ZIP;1 / MDF_ENG.DOC < prev    next >
Encoding:
Text File  |  1994-03-07  |  9.7 KB  |  365 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                   MDIFF  -  MPATCH
  14.  
  15.                                     Release  1.20
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.            A simply and complete software to produce and apply patches to
  30.                             your programs and data files.
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                                    English manual.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                   (C) 1994/95 Maurizio Giunti - All rights reserved
  56.  
  57.  
  58.  
  59.  
  60.  
  61.          1.INDEX
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.          1.INDEX ..................................................2
  70.  
  71.          2.WHY ? ..................................................3
  72.  
  73.          3.WHAT MDIFF-MPATCH DOES ? ...............................3
  74.  
  75.          4.DOS AND OS/2 ...........................................3
  76.  
  77.          5.LIMITS .................................................3
  78.  
  79.          6.MDIFF - MDIFF2 .........................................3
  80.  
  81.          7.MPATCH - MPATCH2 .......................................4
  82.  
  83.          8.ADVICES ................................................4
  84.  
  85.          9.RIGHTS .................................................5
  86.  
  87.          10.WARRANTY ..............................................5
  88.  
  89.          11.HOW TO REGISTER .......................................5
  90.  
  91.          12.ACKNOWLEDGEMENTS ......................................6
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                 - 2 -
  118.  
  119.  
  120.  
  121.  
  122.  
  123.          2.WHY ?
  124.          Some week ago I had to release a new version of a program written
  125.          by me: the compressed packet was about 200 KBytes,  and I thought
  126.          that it was better to update the old version of  the program with
  127.          a patch.I looked for patch makers/appliers programs but I did not
  128.          find any software  that satisfied  me. Moreover I  did'nt find  a
  129.          software that runs both under Dos and OS/2 2.xx.
  130.          I decided to make my own patch software and.....here it is ! 8-)
  131.  
  132.  
  133.  
  134.          3.WHAT MDIFF-MPATCH DOES ?
  135.  
  136.          MDIFF creates a binary difference between two  files. With MPATCH
  137.          and the older file  you can create the  newer file using  the the
  138.          difference file.  Where  is the  advantage  ? Easy:  usually  the
  139.          difference file is  smaller than newer  file, so it's  convenient
  140.          distribute it, expecially by modem.
  141.  
  142.  
  143.  
  144.          4.DOS AND OS/2
  145.  
  146.          In the distribution  packet you will  find 4 executable  files, 2
  147.          for Dos  and  2  for  OS/2  2.xx. There  are  no  differences  in
  148.          functions and usage of  the different versions.  Difference files
  149.          produced with MDIFF for Dos can be used with MPATCH for OS/2 2.xx
  150.          and vice-versa.
  151.  
  152.  
  153.  
  154.          5.LIMITS
  155.  
  156.          MDIFF can't work on files greater than 16  Mbytes. Moreover MDIFF
  157.          Dos version can't work on files  greater than the amount  of free
  158.          conventional memory of the  system. OS/2 version, thanks  to OS/2
  159.          flat memory model, is not affected by this limitation.
  160.  
  161.  
  162.  
  163.          6.MDIFF - MDIFF2
  164.  
  165.          MDIFF compares 2 files and stores the differences between them in
  166.          a difference file. This is the command line syntax:
  167.  
  168.                 MDIFF [-C<c>] [-R<r>] <OldFile> <NewFile> [<MDFfile>]
  169.  
  170.          <OldFile> is the name of the older file, <NewFile> is the name of
  171.          the newer  file. If  you wish  you can  specify the  name of  the
  172.          difference file  that MDIFF  will produce,  otherwise MDIFF  will
  173.          create a  file with  the name  of  the newer  file  but with  the
  174.          extension ".MDF".
  175.          To search differences between files,  MDIFF use a base  string of
  176.          defined lenght named  Chunk. The  Chunk lenght is  by default  16
  177.  
  178.  
  179.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                 - 3 -
  180.  
  181.  
  182.  
  183.  
  184.  
  185.          bytes, but you  can change it,  in the range  4-256, with the  -C
  186.          switch followed by the desired lenght.
  187.          When MDIFF  loses the  synchronism between  the  two files  being
  188.          compared,  it  scans  the   older  file  searching   the  current
  189.          chunk.This scansion  is executed,  by default,  in a  range of  8
  190.          blocks of 512 bytes each. You can change the number of the blocks
  191.          scanned, in the range  1-16, with the  -R switch followed  by the
  192.          desired number of blocks.
  193.          If this  search  fails,  MDIFF  tries  to  force  synchronization
  194.          through a large range  search. This range  is defined as  1/16 of
  195.          the old  file  lenght.  The  second  search can  be  disabled  by
  196.          specifying -F switch on the command line.
  197.          If you  specify -S  switch, MDIFF  will  output some  information
  198.          about the composition of the diff file.
  199.  
  200.  
  201.  
  202.          7.MPATCH - MPATCH2
  203.  
  204.          With the old file and the .MDF file you can rebuild  the new file
  205.          running MPATCH. This is the command line syntax:
  206.  
  207.                       MPATCH <MDFfile> [<OldFile>] [<NewFile>]
  208.  
  209.          MPATCH needs only the name of the mdf file (<MDFfile>) because it
  210.          contains the names  of the other  2 files,  but it's possible  to
  211.          override these names  by simply specifying  the desired names  on
  212.          the command line. MPATCH does not have any switches.
  213.  
  214.  
  215.  
  216.          8.ADVICES
  217.  
  218.          The best method  to build  a difference  file, is  to search  the
  219.          chunks of the newer file in the entire older file, but  this is a
  220.          very slow way to do !
  221.          MDIFF's algorithm tries to give a  small diff file in  the faster
  222.          way; so you  are sometimes required  to tune the  work parameters
  223.          with the command line switches.
  224.          Let's look some tipical situations:
  225.          1. Very similar  files: use  a large  chunk (32,  64 or  more) to
  226.             reduce the size of the diff file.
  227.          2. Text files: try  to use a  chunk size  of 32,  sometimes it is
  228.             better to turn the forced sync off, with the -F switch.
  229.          3. Very large executable: try to use a larger resync range (16 or
  230.             more), with the -R switch.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                 - 4 -
  242.  
  243.  
  244.  
  245.  
  246.  
  247.          9.RIGHTS
  248.  
  249.          This software belongs to Shareware programs: anyone can freely
  250.          distribute and use it for a trial period of 15 days. After this
  251.          period, users that continue to use it must register their copy by
  252.          sending the registration fee to the author, Maurizio Giunti.
  253.          Users that get registered will receive a "registration key".
  254.          Anyone can re-distribute this software, but only if he/she asks
  255.          back no money, except for copy and/or shipping expenses (anyway,
  256.          these expenses must be carefully documented). Another condition
  257.          that you must follow to distribute it, is to furnish the ORIGINAL
  258.          packet always, without any modifications to the program and/or
  259.          documentation.
  260.          There  is  an  exception:  you  can   distribute  MPATCH.EXE  (or
  261.          MPATCH2.EXE) with  one  or  more  *.MDF  files  produced  with  a
  262.          REGISTERED copy of MDIFF.
  263.  
  264.  
  265.  
  266.          10.WARRANTY
  267.  
  268.          The only warranty that comes with  this software is that  it will
  269.          occupy disk space. I absolutely can NOT warrant you  that it will
  270.          perfectly work, or that it will be your problems' resolution.
  271.          Nevertheless, I  am sure  that it  is not  a virus  and does  not
  272.          contain (unless  infected  or  modified  after  the  compilation)
  273.          Trojan-horses, backdoors and similar tricky garbage. In any case,
  274.          the author is not responsible for any damage,  moral or material,
  275.          direct or indirect, derived from its usage.
  276.  
  277.  
  278.  
  279.          11.HOW TO REGISTER
  280.  
  281.          The individual registration key  costs 15,000 Italian  Lire. Site
  282.          licenses available on request. The key is valid for  both Dos and
  283.          OS/2 version of the software. Add  to this cost the  expenses for
  284.          key sending, that  is 1,000  Lire for  Italy and  2,000 Lire  for
  285.          other countries. The registration key will  be sent via mail, but
  286.          if explicitly required, it  can be also  sent via FAX,  for Italy
  287.          only. The fee should be paid  using a postal order (in  Italy) or
  288.          an international postal order in Italian Lire from outside (check
  289.          with your  local post  office),  payable to  the  post office  of
  290.          FIRENZE. The addressee of the order must be the following:
  291.  
  292.                                    Maurizio Giunti
  293.                                 Via G.B. Foggini, 24
  294.                                  50142 Firenze (FI)
  295.                                         ITALY
  296.  
  297.          It  is better  to indicate on the  order the name of  the program
  298.          you want  to register, your  name, address and FAX  number (where
  299.          required). For  short notes,  use the  appropriate  space on  the
  300.          postal order (if present), or at  best send a Netmail  message to
  301.          Maurizio Giunti on 2:332/102.3 at Fidonet.
  302.  
  303.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                 - 5 -
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.          12.ACKNOWLEDGEMENTS
  313.  
  314.          I'd like to  shortly thanks all  those who  helped me to  develop
  315.          this software and its documentation  and all those who  helped me
  316.          in beta-testing. In alphabetical order:
  317.  
  318.                                     Silvia Borri
  319.                                     Filippo Dini
  320.                                  Fabrizio Fioravanti
  321.                                  Cristiano Guidoccio
  322.                                 Giovanni Lopes Pegna
  323.                                   Marco Maccaferri
  324.                                    Giuseppe Scarpi
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                 - 6 -